home *** CD-ROM | disk | FTP | other *** search
/ The Ultimate Window Set -…Games & Quality Programs / The Ultimate Window Set - 250 Games & Quality Programs.iso / win / pro203 / counter.txt < prev    next >
Text File  |  1991-08-01  |  5KB  |  118 lines
  1.  
  2.  
  3. Documentation to Counter Ver. 1.0
  4. By L. D. Math          July, 1991
  5. Silicon Laboratories, Seattle, WA.
  6.  
  7. **************Disclaimer and Legal Mumbo Jumbo:*******************
  8. Counter is FREE. It may be sold if you can find somebody naive enough
  9. to buy it, but no payment is required or requested. If you think that 
  10. Counter is so great that you can't sleep at night without sending me some 
  11. money, then feel free; my address is:
  12.     
  13.          L. D. Math, 2936 NE 178th St., Seattle, WA. 98155-4023
  14.  
  15. $5.00 would be plenty.
  16. Counter is not guaranteed in any way, shape, or form. You use Counter
  17. at your own risk, regardless of any possible consequences that may 
  18. occur before, during or after it's use. I will not be held liable for
  19. any damages that result from using Counter.
  20. My Own Two Cent's Worth: Counter has been tested pretty well before it was
  21. released. No known "bugs" or "undocumented program features" exist as of
  22. this release. That doesn't mean there aren't any, just that there are none 
  23. that I know of. Counter uses approved programming techniques and does not
  24. fool around with your system hardware at all. Counter simply reads a seconds 
  25. register and does a quickie-calculation to see how much time is left.
  26. Counter does not write to your hard drive, nor does it alter any data or 
  27. system parameters. Nonetheless, I won't be responsible if you misuse it
  28. and somehow cause the Earth to split in half.
  29.   
  30.  
  31. **********Overview:
  32.  
  33. Counter is a handy little Visual Basic program that will countdown to a
  34. time you specify and then sound an alarm. Counter is useful for those long
  35. up/download sessions. After your file transfer has begun, simply note
  36. how long it will take, and set Counter for a few minutes less. As your
  37. file transfer nears the end, Counter will time-out and give you a few
  38. moments notice so you can prepare for the end of the transfer. Counter
  39. may also be used for any other application that you see fit.
  40.  
  41.  
  42. **********Requirements:
  43. Any AT or better capable of running Windows 3.0 in Standard or Enhanced 
  44. mode, about 20K of disk space and the VBRUN100.DLL file, available on most
  45. Public Domain BBS's for free.  
  46.  
  47. **********Controls:
  48.  
  49. "START" Button
  50. Starts Counter if a time has been input. Activated (optionally) by the 
  51. <SPACEBAR> when Counter is paused. Changes to "CONTINUE" when Counter 
  52. is paused.
  53.  
  54. "STOP" Button
  55. Pauses Counter. Activated (optionally) by the <SPACEBAR> when counting.
  56. Changes the "START" button into a "CONTINUE" button.
  57.  
  58. "CLEAR" Button
  59. Clears any remaining time in Counter and resets to 00:00:00.
  60. Also stops the alarm sound when it is going off.
  61.  
  62. "QUIT" Button
  63. Quits Counter after first confirming that you really want to quit.
  64.  
  65. HOUR, MINUTE and SECOND Controls
  66. Located beneath the Time Display, these are used to enter or change the 
  67. counter time. Maximum = 23:59:59. These allow for fast, easy setup of
  68. the time value. May be changed when Counter is paused or stopped.
  69.  
  70. Menu Bar:
  71.  
  72. "About"
  73. Shows info on Counter.
  74.  
  75. "Exit"
  76. Quits Counter *NOW*, doesn't pester you by asking if you're sure.
  77.  
  78. **********Features:
  79.  
  80. Once Counter is started, it may be toggled on and off (paused) with the
  81.  <SPACEBAR>. When the alarm sounds, it may be silenced with the <SPACEBAR>
  82.  or by the CLEAR button.
  83. When Counter is minimized to an icon, it displays the time remaining
  84. in the icon caption.
  85. Counter uses only one timer function in the operating system, so it
  86. won't load down your system with a lot of extra overhead.
  87. Counter uses the bare minimum of system resources.
  88. Counter will keep correct time even if it can't read the system clock for
  89. extended periods of time.
  90. If Counter is minimized, Counter will return to it's normal size when the 
  91. alarm goes off.
  92.  
  93. **********Etcetera
  94. The Up/Down Time Set controls seem to work upside down, but that's 
  95. function of Visual Basic, not wierd programming on my part. When I
  96. figure out how to correct it, I'll put it in ver. 1.1.  Actually, I should
  97. claim this is a program feature, in that it puts the "UP" buttons (which 
  98. you are more likely to use than the "DOWN" buttons) closer to the START/STOP
  99. buttons. But I won't.
  100. The numbers Counter uses may look blocky, depending upon your system.
  101. A version that allows you to pick your own font may follow this release.
  102. Future versions of Counter will probably include the ability to time an event
  103. and perhaps run a program or a sound file you provide. Sound support for 
  104. Visual Basic is bleak at the moment, but this is expected to improve before 
  105. long. If you have an idea for something you would like to see in Counter, 
  106. write me and let me know. If it's reasonable, I'll try to put it in.
  107.  
  108. If you find a bug in Counter, write me and describe the problem. I will
  109. fix the bug (or die trying) and send you back an updated version.
  110. Please try and include as much information about the problem as you can.
  111. (e.g. "When I count past midnight, Counter makes the Earth split in half,
  112. and Counter also loses several seconds.")
  113.  
  114. ***************************************************************************
  115. Counter is Copyright (c) 1991 by L.D. Math. Counter may not be modified
  116. or altered without permission. The source code for Counter is available
  117. for one dollar from the address above.
  118.